Release 10.1A: OpenEdge Data Management:
Database Administration

PROUTIL CONVFILE qualifier

Converts a text file from one character set to any other character set.

Syntax

proutil -C convfile { file-name convert using table-name                     | file-name [ analyze ] }

Parameters

file-name

Specifies the name of the file you are converting or analyzing.

convert using table-name

Specifies the name of the file containing the conversion table. This file requires the following format:

# optional comment lines begin with the # character SOURCE source-codepage-name TARGET target-codepage-name /*000-015*/000  001 002 003 004 005 006 007 008 009 010 011 012 013 014 /*016-031*/016  017 018 019 020 021 022 023 024 025 026 027 028 029 030 /*032-047*/032  033 034 035 036 037 038 039 040 041 042 043 044 045 046                                        .                                        .                                        . /*240-255*/240  241 242 243 244 245 246 247 248 249 250 251 252 253 254

where source-codepage-name is the name of the character set of file-name, and target-codepage-name is the name of the desired character set for file-name.

The conversion table is composed of 256 cells, numbering from 0 to 255. You can build your own conversion table, or you can use default tables stored in the DLC/prolang directory if appropriate. The tables in DLC/prolang are as follows:

1250-852.dat — Converts from code page 1250 to IBM code page 852.
1250-il2.dat — Converts from code page 1250 to iso8859-2.
1254-857.dat —Converts from IBM code page 1254 to code page 857.
852-1250.dat — Converts from IBM code page 852 to code page 1250.
852-il2.dat — Converts from IBM code page 852 to iso8859-2.
857-1254.dat — Converts from IBM code page 857 to code page 1254.
cn850.dat — Converts iso8859-1 to IBM code page 850.
cn8859-1.dat — Converts IBM code page 850 to iso8859-1.
cnnull.dat — Performs no conversion; you might want to use this file as a template file for creating new conversion tables.
il2-1250.dat — Converts from iso8859-2 to code page 1250.
il2-852.dat — Converts from iso8859-2 to IBM code page 852.

If you create your own conversion table, you must understand how PROUTIL CONVFILE uses the table. For each character in file-name, PROUTIL CONVFILE uses the character’s numeric value to index it against the table. When it locates the corresponding cell, PROUTIL CONVFILE replaces the character in the text file with the character value in that cell. Therefore, you must make a copy of the text file before you run the PROUTIL CONVFILE utility, because if the utility does not completely convert the file, the data in it is corrupted.

analyze

Displays the number of occurrences of each character in file-name. You might be able to determine the character set of file-name by comparing the output of this option against different code pages.